<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
</head>
<body>

<h3>发送文件(绑定开发者)</h3>
<table>
	<tr><td colspan=2>SendFileA(BSTR username, BSTR account, LONG gameType, BSTR filePath, LONG interval)</td></tr>
	<tr><td colspan=2><span>参数:</span></td></tr>
	<tr><td>username</td><td>开发者用户名,字符串</td></tr>
	<tr><td>account</td><td>子账号,字符串</td></tr>
	<tr><td>gameType</td><td>项目类型,整数</td></tr>
	<tr><td>filePath</td><td>文件路径,字符串,如"C:/1.gif",当前支持JPG/JPEG,GIF,PNG,BMP格式的文件,最大长度限制64KB,文件路径必须包含后缀名,否则无法识别格式</td></tr>
	<tr><td>interval</td><td>超时时间,整数,单位为秒,最少15,最大200,一般设置为0,表示以平台定义的超时时间为准;该参数只在某些自定义超时时间的项目中生效</td></tr>
	<tr><td colspan=2><span>返回值:</span></td></tr>
	<tr><td>成功</td><td>返回消息ID字符串,用作后续获取答案的参数;发送成功将会扣除题分,重复发送将重复扣分</td></tr>
	<tr><td>失败</td><td>返回以'-'开头的错误码字符串</td></tr>
</table>

<h3>发送文件(分成模式)</h3>
<table>
	<tr><td colspan=2>SendFileB(BSTR username,BSTR account, LONG gameType, BSTR filePath, LONG interval, LONG point, BSTR returnUser)</td></tr>
	<tr><td colspan=2><span>参数:</span></td></tr>
	<tr><td>username</td><td>开发者用户名,字符串</td></tr>
	<tr><td>account</td><td>子账号,字符串</td></tr>
	<tr><td>gameType</td><td>项目类型,整数</td></tr>
	<tr><td>filePath</td><td>文件路径,字符串,如"C:/1.gif",当前支持JPG/JPEG,GIF,PNG,BMP格式的文件,最大长度限制64KB,文件路径必须包含后缀名,否则无法识别格式</td></tr>
	<tr><td>interval</td><td>超时时间,整数,单位为秒,最少15,最大200,一般设置为0,表示以平台定义的超时时间为准;该参数只在某些自定义超时时间的项目时才生效</td></tr>
	<tr><td>point</td><td>点数,整数,表示该题需要扣除的点数,一般设置为0,表示以平台定义的点数为准;该参数允许开发者自定义扣除的点数(关于该参数的计算请参看常见问题)</td></tr>
	<tr><td>returnUser</td><td>返点开发者,字符串,分成模式下返点的开发者</td></tr>
	<tr><td colspan=2><span>返回值:</span></td></tr>
	<tr><td>成功</td><td>返回消息ID字符串,用作后续获取答案的参数;发送成功将会扣除题分,重复发送将重复扣分</td></tr>
	<tr><td>失败</td><td>返回以'-'开头的错误码字符串</td></tr>
</table>

<h3>发送文件</h3>
<table>
	<tr><td colspan=2>SendFile(BSTR account, LONG gameType, BSTR filePath, LONG interval)</td></tr>
	<tr><td colspan=2><span>参数:</span></td></tr>
	<tr><td>account</td><td>子账号,字符串</td></tr>
	<tr><td>gameType</td><td>项目类型,整数</td></tr>
	<tr><td>filePath</td><td>文件路径,字符串,如"C:/1.gif",当前支持JPG/JPEG,GIF,PNG,BMP格式的文件,最大长度限制64KB,文件路径必须包含后缀名,否则无法识别格式</td></tr>
	<tr><td>interval</td><td>超时时间,整数,单位为秒,最少15,最大200,一般设置为0,表示以平台定义的超时时间为准;该参数只在某些自定义超时时间的项目时才生效</td></tr>
	<tr><td colspan=2><span>返回值:</span></td></tr>
	<tr><td>成功</td><td>返回消息ID字符串,用作后续获取答案的参数</td></tr>
	<tr><td>失败</td><td>返回以'-'开头的错误码字符串</td></tr>
</table>

<h3>获取答案</h3>
<table>
	<tr><td colspan=2>GetAnswer(BSTR msgID)</td></tr>
	<tr><td colspan=2><span>参数:</span></td></tr>
	<tr><td>msgID</td><td>消息ID,字符串,从发送文件获取的消息ID</td></tr>
	<tr><td colspan=2><span>返回值:</span></td></tr>
	<tr><td>成功</td><td>返回答案字符串,选择题为数字字符;坐标题格式为X,Y;填空题为正常字符串</td></tr>
	<tr><td>失败</td><td>返回以'-'开头的错误码字符串,其中"-2"表示答案未准备好,"-20"表示无法识别图片,"-21"表示重复图片,"-22"表示超时未回答;若答案类似于"-XXXX",则答案将替换为"#XXXX"</td></tr>
</table>

<h3>报告错题</h3>
<table>
	<tr><td colspan=2>Report(BSTR account, BSTR msgID)</td></tr>
	<tr><td colspan=2><span>参数:</span></td></tr>
	<tr><td>account</td><td>子账号,字符串</td></tr>
	<tr><td>msgID</td><td>消息ID,字符串,从发送文件获取的消息ID</td></tr>
	<tr><td colspan=2><span>返回值:</span></td></tr>
	<tr><td>成功</td><td>返回"0",<span style="color:red">扣取的题分将在三分钟后返还;如果误报将扣除双倍题分,恶意频繁报错将导致账号被冻结</span></td></tr>
	<tr><td>失败</td><td>返回以'-'开头的错误码字符串</td></tr>
</table>

<h3>创建子账号</h3>
<table>
	<tr><td colspan=2>CreateAccount(BSTR username, BSTR password, LONG batchSize, LONG point, BSTR validDate)</td></tr>
	<tr><td colspan=2><span>参数:</span></td></tr>
	<tr><td>username</td><td>开发者用户名,字符串</td></tr>
	<tr><td>password</td><td>开发者密码,字符串</td></tr>
	<tr><td>batchSize</td><td>创建个数,整数,最多100个,最少1个,每天累计不可超过10000</td></tr>
	<tr><td>point</td><td>初始点数,整数,最少100点,最大不超过开发者的可用点数</td></tr>
	<tr><td>validDate</td><td>有效期,字符串,两种格式:日期或者天数,日期格式如"2013-12-31",表示有效期至2013年12月31日;天数格式如"365",表示子账号第一次使用的365天内有效.</td></tr>
	<tr><td colspan=2><span>返回值:</span></td></tr>
	<tr><td>成功</td><td>返回创建的子账号序列字符串,以逗号分割,如 "XXXXX,XXXXX"</td></tr>
	<tr><td>失败</td><td>返回以'-'开头的错误码</td></tr>
</table>


<h3>子账号查询(绑定开发者)</h3>
<table>
	<tr><td colspan=2>QueryAccountA(BSTR username, BSTR account)</td></tr>
	<tr><td colspan=2><span>参数:</span></td></tr>
	<tr><td>account</td><td>开发者用户名,字符串</td></tr>
	<tr><td>account</td><td>子账号,字符串</td></tr>
	<tr><td colspan=2><span>返回值:</span></td></tr>
	<tr><td>成功</td><td>返回子账号的原始点数、已用点数、剩余点数、有效期,以逗号分割,如 "1000,200,800,2013-12-31 23:59:59",查询操作<span style="color:red">会</span>激活以天数为有效期的子账号。</td></tr>
	<tr><td>失败</td><td>返回以'-'开头的错误码</td></tr>
</table>

<h3>子账号查询</h3>
<table>
	<tr><td colspan=2>QueryAccount(BSTR account)</td></tr>
	<tr><td colspan=2><span>参数:</span></td></tr>
	<tr><td>account</td><td>子账号,字符串</td></tr>
	<tr><td colspan=2><span>返回值:</span></td></tr>
	<tr><td>成功</td><td>返回子账号的原始点数、已用点数、剩余点数、有效期,以逗号分割,如 "1000,200,800,2013-12-31 23:59:59",查询操作<span style="color:red">不会</span>激活以天数为有效期的子账号。</td></tr>
	<tr><td>失败</td><td>返回以'-'开头的错误码</td></tr>
</table>

<h3>主账号查询</h3>
<table>
	<tr><td colspan=2>QueryUser(BSTR username,BSTR password)</td></tr>
	<tr><td colspan=2><span>参数:</span></td></tr>
	<tr><td>username</td><td>开发者用户名,字符串</td></tr>
	<tr><td>passwrod</td><td>开发者密码,字符串</td></tr>
	<tr><td colspan=2><span>返回值:</span></td></tr>
	<tr><td>成功</td><td>返回主账号的剩余点数、返点数,以逗号分割,如 "1000,400"</td></tr>
	<tr><td>失败</td><td>返回以'-'开头的错误码</td></tr>
</table>
<!-- 
<h3>子账号充值</h3>
<table>
	<tr><td colspan=2>RechargeAccount(BSTR account, BSTR rechargeCard)</td></tr>
	<tr><td colspan=2><span>参数:</span></td></tr>
	<tr><td>account</td><td>子账号,字符串</td></tr>
	<tr><td>rechargeCard</td><td>充值卡号,字符串,必须是同一开发者创建的充值卡</td></tr>
	<tr><td colspan=2><span>返回值:</span></td></tr>
	<tr><td>成功</td><td>返回充值卡的点数</td></tr>
	<tr><td>失败</td><td>返回以'-'开头的错误码</td></tr>
</table>

<h3>创建充值卡</h3>
<table>
	<tr><td colspan=2>CreateRechargeCard(BSTR username, BSTR password, LONG batchSize, LONG point, BSTR validDate)</td></tr>
	<tr><td colspan=2><span>参数:</span></td></tr>
	<tr><td>username</td><td>开发者用户名,字符串</td></tr>
	<tr><td>password</td><td>开发者密码,字符串</td></tr>
	<tr><td>batchSize</td><td>创建个数,整数,最多100个,最少1个,每天累计不可超过10000</td></tr>
	<tr><td>point</td><td>初始点数,整数,最少100点,最大不超过开发者的可用点数</td></tr>
	<tr><td>validDate</td><td>有效日期,字符串,格式如"2012-12-22"</td></tr>
	<tr><td colspan=2><span>返回值:</span></td></tr>
	<tr><td>成功</td><td>返回创建的充值卡序列字符串,以逗号分割,如 "XXXXX,XXXXX"</td></tr>
	<tr><td>失败</td><td>返回以'-'开头的错误码</td></tr>
</table>

<h3>创建子账号(由充值卡)</h3>
<table>
	<tr><td colspan=2>CreateAccountByRC(BSTR username, BSTR rechargeCard)</td></tr>
	<tr><td colspan=2><span>参数:</span></td></tr>
	<tr><td>username</td><td>开发者用户名,字符串</td></tr>
	<tr><td>batchSize</td><td>充值卡号,字符串,必须是同一开发者创建的充值卡</td></tr>
	<tr><td colspan=2><span>返回值:</span></td></tr>
	<tr><td>成功</td><td>返回创建的子账号字符串</td></tr>
	<tr><td>失败</td><td>返回以'-'开头的错误码</td></tr>
</table>
 -->
<h3>创建子账号(由开发者指定32位编码后缀)</h3>
<table>
	<tr><td colspan=2>CreateAccountA(BSTR username, BSTR password, BSTR suffix, BSTR validDate, LONG point)</td></tr>
	<tr><td colspan=2><span>参数:</span></td></tr>
	<tr><td>username</td><td>开发者用户名,字符串</td></tr>
	<tr><td>password</td><td>开发者密码,字符串</td></tr>
	<tr><td>suffix</td><td>编码,字符串,32位编码,由[0-9a-zA-Z]组成</td></tr>
	<tr><td>validDate</td><td>有效期,字符串,两种格式:日期或者天数,日期格式如"2013-12-31",表示有效期至2013年12月31日;天数格式如"365",表示子账号激活后365天内有效.</td></tr>
	<tr><td>point</td><td>初始点数,整数,最少100点</td></tr>
	<tr><td colspan=2><span>返回值:</span></td></tr>
	<tr><td>成功</td><td>返回创建的子账号字符串</td></tr>
	<tr><td>失败</td><td>返回以'-'开头的错误码</td></tr>
</table>

<h3>合并子账号</h3>
<table>
	<tr><td colspan=2>MergeAccount(BSTR accountA, BSTR accountB)</td></tr>
	<tr><td colspan=2><span>参数:</span></td></tr>
	<tr><td>accountA</td><td>子账号A,字符串</td></tr>
	<tr><td>accountB</td><td>子账号B,字符串,必须是同一开发者创建的子账号</td></tr>
	<tr><td colspan=2><span>返回值:</span></td></tr>
	<tr><td>成功</td><td>返回合并后的子账号A的信息,格式如查询子账号</td></tr>
	<tr><td>失败</td><td>返回以'-'开头的错误码</td></tr>
</table>

</body>
</html>